home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / pmove20.zip / PMOVE.DOC < prev    next >
Text File  |  1987-09-23  |  21KB  |  540 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                    P M O V E
  17.  
  18.                                        by
  19.  
  20.                                  Norm Patriquin
  21.  
  22.  
  23.  
  24.                                    Version 2.0
  25.                                     June 1986
  26.  
  27.  
  28.  
  29.                         Table of Contents
  30.  
  31.  
  32.       What is PMOVE . . . . . . . . . . . . . . . . . . . . . .   1
  33.       What PMOVE does . . . . . . . . . . . . . . . . . . . . .   2
  34.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  35.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   6
  36.       Registering PMOVE . . . . . . . . . . . . . . . . . . . .   7
  37.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  38.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  39.       Other Utilities . . . . . . . . . . . . . . . . . . . . .  10
  40.                                                                 Page  1
  41.  
  42.       What is PMOVE
  43.       -------------
  44.  
  45.       PMOVE is a DOS command utility used to move files between
  46.       disks and directories on disks.  PMOVE combines the functions
  47.       of DOS COPY and DELETE commands to make make moving files
  48.       very easy.  In addition to just moving files, PMOVE also
  49.       allows selection criteria to be specified to better qualify
  50.       the files to be moved.
  51.  
  52.       PMOVE automatically determines the environment the move is
  53.       requested for and then determines if the data must be moved
  54.       or if the file can be moved by renaming.  Moving with rename
  55.       is allowed if the move is to another directory on the same
  56.       disk device.  If a rename move can be done, it is much faster
  57.       than moving the data, it helps to keep from fragmenting disk
  58.       free space, and allows very large files to be moved between
  59.       directories when they could not normally be moved with DOS
  60.       COPY because of insufficient space.
  61.  
  62.       PMOVE is developed to allow standard DOS wildcard pathnames
  63.       in the source file specifications, and standard pathnames
  64.       for the target directory specification.  Wildcards are not
  65.       allowed for the target path specification.
  66.  
  67.       PMOVE attempts to anticipate your needs and help you accomplish
  68.       your task.  For instance, if PMOVE determines that the target
  69.       directory name does not exist, it will ask you if it is to be
  70.       created.  If you respond <YES>, the directory will be created
  71.       for you.
  72.  
  73.       I have tried to develop PMOVE with all the features normally
  74.       needed for this kind of utility.  I hope you find what you
  75.       need and that the utility is of use to you.
  76.  
  77.       For an immediate command summary, enter the PMOVE command without
  78.       any parameters.  A help screen will be displayed.
  79.  
  80.  
  81.                                                                 Page  2
  82.       What PMOVE does:
  83.       ----------------
  84.  
  85.         **  Moves files by copying them or renaming them to the new
  86.             location.
  87.  
  88.         **  Deletes the original file if needed and /C is NOT specified.
  89.  
  90.         **  Creates target directory if needed.
  91.  
  92.         **  Makes sure the DOS archive flag is set correctly for each
  93.             file as it is moved.
  94.  
  95.         **  Preserves the DOS date and time for each file moved.
  96.  
  97.         **  Allows user to pause move at any time by pressing any
  98.             keyboard key.  Once stopped, the move can be terminated
  99.             by pressing escape.
  100.  
  101.         **  Provides file selection and processing control options
  102.             to tailor the move process to your own needs.
  103.  
  104.         **  Allows commands to be tested so you may be sure
  105.             that commands are specified as you desire.
  106.  
  107.         **  Copy updated files to a special disk or directory.
  108.  
  109.         **  If there is not sufficient space on the current target
  110.             disk, PMOVE will allow you to place another disk in the
  111.             drive and continue processing.  This allows you to easily
  112.             move groups of files larger than disk size to other
  113.             computers.
  114.  
  115.         **  Start with a specific file in a directory.
  116.  
  117.         **  End with a specific file in a directory.
  118.  
  119.         **  Process files based on the date stored in its directory
  120.             entry.
  121.  
  122.         **  Warns you before overlaying a file unless specific
  123.             parameters indicating otherwise are specified.
  124.  
  125.         **  Checks target disk for available space before starting
  126.             to move files.  This prevents time from being wasted
  127.             when the move will not be able to complete.
  128.  
  129.                                                                 Page  3
  130.  
  131.       Command Mode Parameters
  132.       -----------------------
  133.  
  134.       PMOVE allows several command parameter switches to be specified
  135.       to qualify the move criteria.  All these parameters are
  136.       optional.  The PMOVE command is used like DOS COPY except for
  137.       these switches.  The command format and switch parameters are
  138.       described below.  A quick review of command parameters is always
  139.       available by entering the PMOVE command without any parameters.
  140.  
  141.  
  142.       COMMAND FORMAT:
  143.  
  144.       PMOVE from_file_spec [to_file_spec] [ (/ switches) ]
  145.  
  146.  
  147.       [from}    Enter the DOS file specification for the directory and
  148.                 file names to be moved.
  149.  
  150.                 The filename portion of the file specification may
  151.                 contain wildcard characters documented by DOS (* and
  152.                 ?).
  153.  
  154.  
  155.       [to]      Enter the DOS file specification for the directory and
  156.                 filename to be copied to.  If the "to" specification
  157.                 is not entered, files will be moved to the current
  158.                 directory.
  159.  
  160.  
  161.       /N        Only move files that do not already exist on the target
  162.                 directory. (New files).  If the file already exists,
  163.                 no attempt will be made to move it and no warning
  164.                 message will be printed.
  165.  
  166.  
  167.       /U        Only move files that do not exist on the target
  168.                 directory or duplicate filenames that are newer than
  169.                 their counterparts on the target directory or disk.
  170.  
  171.                 Use of this option results in the most current version
  172.                 of each selected file being at the target location.
  173.  
  174.  
  175.       /R        Replace any duplicate files on the target disk or
  176.                 directory regardless of their dates.
  177.  
  178.  
  179.       /E        Select and move only files that exist on both the "from"
  180.                 and "to" directories.  This causes all duplicate named
  181.                 files to be replaced.
  182.                                                                 Page  4
  183.  
  184.  
  185.       /T        Test the move process.  Use this switch when you
  186.                 would like to test the PMOVE command entered without
  187.                 actually moving any files or creating any directories.
  188.  
  189.                 Messages will indicate what will happen if the command
  190.                 is executed without the /T switch.
  191.  
  192.  
  193.       /P        Pause before each file is moved and ask for approval
  194.                 to process it.
  195.  
  196.  
  197.       /C        Copy only.  Do not delete the file after it is copied.
  198.  
  199.  
  200.       /M        Stop screen from scrolling from scrolling past the end
  201.                 without user intervention (MORE).
  202.  
  203.  
  204.       /A        Only select files that have the DOS archive attribute
  205.                 set.  This attribute is set by DOS whenever a file
  206.                 has been created or updated.  The attribute is reset
  207.                 by most backup facilities including the DOS BACKUP
  208.                 command.
  209.  
  210.  
  211.       /F:file   First.  Indicates that processing is not to start until
  212.                 the specified full filename is encountered in the
  213.                 scan of the directory.
  214.  
  215.                 This parameter is most useful in restarting a
  216.                 move or copy from a location where it had
  217.                 previously left off.
  218.  
  219.  
  220.       /L:file   Last.  Indicates that processing is to stop after
  221.                 the spec